home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_2
/
pledge12.zip
/
SYSOP.DOC
< prev
next >
Wrap
Text File
|
1992-12-15
|
8KB
|
223 lines
PLEDGE BANK v1.2
SYSOP DOCUMENTATION
by
Thomas W. Burker
Using the GAPQBDR Interface Module from GAP Development Company
and compiled QBasic code v4.5
Registered with the GAP Communications Company
Registration # 5210
TomTron Software Development
(c) copyright 1992 all rights reserved
The latest version of PLEDGE BANK is always available on PC NITELINE
in file directory #1 - TomTron Door Programs
- or on the -
Night Shift BBS
(216) 941-9420 (216) 941-9921
*** beta testing at its finest ***
Here is a unique way to let your users/members pledge money toward the
operation and maintenance of your DOORS. It allows the user to choose
the DOOR to sponsor and the amount of money to pledge per logon. We
are not talking about a ( LOT ) of money here, but it can add up and it
gives your users a novel way to pledge. They can choose from 1¢ minimum
to 10¢ maximum per logon. They can check their balance at anytime AFTER
the first logon and pledge. Their personal file is always updated. I did
decide to use individual .DAT files rather than maintaining a random
access file. Deleting individual users is made easy this way, and all of
the user files are kept in the PLEDGE directory.
A user file is automatically created by using the last 5 characters of
their last name and the first 3 characters of their first name + the
.DAT extension. This information is obtained by a quick read to the
DOOR.SYS file.
When they send in their pledge (at anytime really), you can just delete
their user file and add them to the PAIDUP.LST text file.
A separate program called PCHECK.EXE is launched from your LOGON.BAT as
the user logs on and re-writes their personal pledge file, adding another
increment to the number of logons. This almost becomes a game to them!
Full instructions are available to the user internally by selecting [I]
for Instructions on the main menu.
===========================
USER PROCEDURE - FIRST TIME
===========================
1. Enters the PLEDGE BANK door.
2. [L]ists the available doors on the BBS that can be pledged.
3. [R]eady to pledge is selected.
4. User enters the name of the door to be pledged. ( Name doesn't have
to be exact; as long as the SysOp recognizes what it is ).
5. User enters the pledge amount from 1 - 10 cents. Higher amounts or 0
will not be accepted and the input will once again be requested.
6. Pledge is recorded and the user leaves the door.
==================================
USER PROCEDURE - SUBSEQUENT VISITS
==================================
1. User can use the [S]how me my pledge account balance to see what he/she
has pledged.
NOTE: If a user pledges another door at anytime before the original pledge
is paid off, that original pledge is over-written by the new pledge.
========
FEATURES
========
-> Supports COM Port speeds up to 38.4 baud.
-> Supports FIFO buffers of the 16550 UART.
-> Supports all communications ports.
-> Does not require WATCHDOG or CTTY.
-> High speed text file display
-> Utilizes user timeout function.
-> Allows SysOp to shell to DOS.
-> Allows SysOp to twit caller without them knowing SysOp is watching.
-> Allows SysOp to increase or decrease time.
-> Allows SysOp chat mode with word wrap.
-> Provides SysOp with informative status line display.
-> Recognizes multiple user systems ( .EXE file date 12/08/92 and later )
==========
PLEDGE.CNF sample
==========
c:\GAP <-- path to the GAP default directory ( where DOOR.SYS is )
PC Niteline <-- BBS Name
0 <-- must be 0 - designates a GAP BBS
Note: Remember to remove the comments from your config file and do
NOT leave any spaces. It MUST consist of 3 lines!
BBSBASE "requires" BRUN45.EXE either in the BBSBASE directory or
in your path!
==========
PCHECK.CNF
==========
This is handles exactly the same as the PLEDGE.CNF arrangement.
==============================
RUNNING LOCALLY FOR EVALUATION
==============================
You may run PLEDGE BANK locally to get a feel for the program and examine
its appearance. There are a couple of things you must do to make this
happen. Follow this setup and you will have no problem.
1. Create a directory and name it PLEDGE.
2. UnZip your distribution archive into the directory.
3. Make sure the first line in the PLEDGE.CNF file points to the PLEDGE
directory path.
4. Place ANY valid DOOR.SYS in this directory and change the FIRST line
of the file to COM0: (p.s. that is COM<zero>:)
5. Launch the program by typing PLEDGE PLEDGE.CNF
================
MULTI-NODE SETUP
================
If you run multi-nodes, you must have a separate .CNF and .BAT file for
each node, i.e. PLEDGE1.CNF, PLEDGE2.CNF......PLEDGE9.CNF
You MUST have the file PLEDGE.EXE dated on or after 12/10/92 to run a
multi-node arrangement. PLEDGE.EXE uses the COMMAND$ function that will
pass the name of any .CNF file that you decide to use to the program.
==============================
FILES INCLUDED IN BBSBAS12.ZIP
==============================
PLEDGE.EXE the executable DOOR program
PCHECK.EXE the executable PCHECK exit program
PLEDGE.CNF sample configuration file
PCHECK.CNF sample configuration file
TOMTRON.REG door registration form
SYSOP.DOC this documentation for SysOps
HISTORY.DOC update reports for BBSBASE
PAIDUP(G) *SysOp defined text file showing paid pledges
DOORLST(G) *SysOp defined text file showing your BBS DOOR names
( NOTE ) : *The names of these files MUST be left as is - DO NOT CHANGE!
You may NOT include XCODES in these text files as they will
not be realized. You may use ANSI codes. If you want both
color and non-color versions of these files, append the color
file with a "G" as in DOORLSTG
======================
NOTE TO NERVOUS SYSOPS
======================
PLEDGE BANK does NOT write to any of your GAP .DAT or system files at ANY
time. The only files that are created are the account.DAT files that are
kept in the PLEDGE directory with the executable and support text files.
==========
PLEDGE.BAT sample (goes in your GAP default directory)
==========
@ECHO OFF
c:
cd \gap\doors\PLEDGE <-- Sample .BAT file
PLEDGE PLEDGE.CNF
cd \GAP
============================
!!! SPECIAL INSTRUCTIONS !!! Follow instructions carefully
============================
In order to have your PCHECK program update their pledges, we must add
the PCHECK program to the LOGON.BAT file in your GAP default directory.
If you don't have one, then create one. Simple add the following:
@ECHO OFF
C: <-- or wherever you have the PLEDGE directory
cd \gap\doors\pledge <-- or whatever the correct path is
PCHECK PCHECK.CNF <-- launch with the correct .CNF extension
cd \gap
PCHECK will look for a users pledge file and update it if it exists.
There is also a short note of recognition OR non-recognition if a pledge
file exists.
=========
IMPORTANT
=========
(Please refer to TOMTRON.REG to register your door)
PLEASE SUPPORT DOORWARE/SHAREWARE!
Dear SysOp:
PLEDGE BANK is not crippled in ANY WAY other than the unregistered memo
in the title screen. Registration is painless and inexpensive. Please
promote the development of new doorware by registering your door.
Thank you!
Thomas W. Burker
TomTron Software Development
PC Niteline BBS
216/942-9451 / HST D/S 16.8